home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / basic / adln15.zip / ADDLINE.DOC next >
Text File  |  1988-08-31  |  9KB  |  233 lines
  1. AddLine (tm)
  2. ADDLINE.DOC
  3. Copyright (c) 1987 Richard B. Levin
  4. All Rights Reserved
  5.  
  6. ============
  7. PROGRAM INFO
  8. ============
  9.  
  10.  Program:  AddLine
  11.  Version:  1.5
  12. Compiled:  August 31, 1988
  13. Function:  Adds line numbers to source code
  14.    Class:  Programmer's utility
  15.    Price:  $1.00 per copy/per PC
  16.   Editor:  Norton Editor v.1.3C
  17. Compiler:  Microsoft BASIC v.6.0
  18. Math LIB:  Alternate (/FPA)
  19.    Trace:  AddLine v.1.5
  20.   Author:  Richard B. Levin
  21.  Contact:  BBSoft, P.O. Box 14546, Phila., PA, 19115
  22.    Voice:  (215) 333-8274
  23.      BBS:  The Mother Board @ (215) 333-8275 (300/1200/2400)
  24.  
  25. Documentation written by:  Richard B. Levin
  26.  
  27. Documentation edited by:  Carol J. Levin
  28.                           Katherine Margolis
  29.  
  30. Principal distribution points:  The BBSoft Support BBS (see above)
  31.                                 CompuServe Information Service IBMNET\IBMSW
  32.                                 CompuServe Information Service MSSYS
  33.  
  34. AddLine is published by:
  35.  
  36.         BBSoft
  37.         9405 Bustleton Ave.     Lab:  (215) 333-8274       We Give
  38.         P.O. Box 14546          BBS:  (215) 333-8275    Free Support!
  39.         Phila., PA  19115
  40.  
  41.         The latest version of AddLine is available for downloading on the
  42. BBSoft Support BBS.  Support is also available through the BBSoft Lab.  Please
  43. leave a message on our answering machine if we are unable to answer your call
  44. personally.  We return long distance calls collect.
  45.  
  46. ================
  47. ARCHIVE CONTENTS
  48. ================
  49.  
  50.         The ADLN15.ARC archive contains three files:
  51.  
  52.                  ADDLINE.DOC - this file
  53.                  ADDLINE.EXE - AddLine v.1.5 executable
  54.                 REGISTER.DOC - BBSoft owner registration form
  55.                 
  56. ================
  57. COPYRIGHT NOTICE
  58. ================
  59.  
  60.         The names "BBSoft," "AddLine," and the AddLine program, documentation,
  61. AddLine-created input and output files, file formats, visual displays,
  62. interface, look, and feel (hereinafter referred to as "the AddLine system")
  63. are copyright (c) and trade mark (tm) 1987 Richard B. Levin (hereinafter
  64. referred to as "the author"), all rights reserved.
  65.  
  66.         The author reserves the right to make changes to the AddLine system at
  67. any time without prior notice.  The AddLine system is provided to the end user
  68. "as is" without warranty of any kind, either express or implied.  No part of
  69. the AddLine system may be reproduced without the express written permission of
  70. the author.
  71.  
  72.         The AddLine system is protected by United States Copyright Law (Title
  73. 17 United States Code).  Unauthorized reproduction, duplication, transfer,
  74. and/or sales may result in imprisonment of up to one year and fines of up to
  75. $10,000.00 (17 USC 506).  Copyright infringers may also be subject to civil
  76. liability.  The Federal Bureau of Investigation investigates allegations of
  77. criminal copyright infringement.
  78.  
  79. ==================
  80. OWNER REGISTRATION
  81. ==================
  82.  
  83.         ------------------------------
  84.         CORPORATE AND GOVERNMENT USERS
  85.         ------------------------------
  86.  
  87.         For-profit, non-profit, and not-for-profit corporations, governmental
  88. offices and agencies, and/or private individuals using AddLine within one of
  89. these classifications, are required to register their ownership of the AddLine
  90. system with the author.  Every registration must be accompanied by a
  91. registration fee of $1.00 for each computer running the AddLine system.
  92.  
  93.         -------------
  94.         PRIVATE USERS
  95.         -------------
  96.  
  97.         Private, individual users of AddLine are required to register their
  98. ownership of the AddLine system with the author, but are not required to remit
  99. the $1.00 registration fee.  Donations are accepted.
  100.  
  101.         ---------
  102.         ALL USERS
  103.         ---------
  104.  
  105.         ADDLINE USERS WHO FAIL TO REGISTER THEIR OWNERSHIP OF THE ADDLINE
  106. SYSTEM ARE IN VIOLATION OF UNITED STATES COPYRIGHT LAW.
  107.  
  108. =================
  109. REGISTRATION FORM
  110. =================
  111.  
  112.         ALL USERS ARE REQUIRED BY LAW TO COMPLETE AND RETURN THIS FORM
  113.            WITHIN TEN DAYS OF THE ACQUISITION OF THE ADDLINE SYSTEM
  114.  
  115. - - - - - - - - - - - - - - - - - Tear Here - - - - - - - - - - - - - - - - - -
  116.  
  117.         Print, complete, and mail to:  BBSoft
  118.                                        AddLine v.1.5 Registration
  119.                                        P.O. Box 14546
  120.                                        Phila., PA  19115
  121.  
  122.         IMPORTANT:  Make checks payable to "Richard B. Levin"
  123.                     Do NOT make checks payable to BBSoft or AddLine
  124.  
  125. Registered Owner Name:  _______________________________________________________
  126.  
  127. _______________________________________________________________________________
  128.  
  129. Title:  _______________________________________________________________________
  130.  
  131. _______________________________________________________________________________
  132.  
  133. Department:  __________________________________________________________________
  134.  
  135. _______________________________________________________________________________
  136.  
  137. Company:  _____________________________________________________________________
  138.  
  139. _______________________________________________________________________________
  140.  
  141. Address:  _____________________________________________________________________
  142.  
  143. _______________________________________________________________________________
  144.  
  145. P.O. Box:  ____________________________________________________________________
  146.  
  147. _______________________________________________________________________________
  148.  
  149. Mail stop:  ___________________________________________________________________
  150.  
  151. _______________________________________________________________________________
  152.  
  153. City:  ________________________________________________________________________
  154.  
  155. State:  _______________________________________________________________________
  156.  
  157. Zip:  _________________________________________________________________________
  158.  
  159. Phone:  _______________________________________________________________________
  160.  
  161. Total number of PC's at site using AddLine:  __________________________________
  162.  
  163. Registration fee enclosed (@ $1.00 per PC):  $ ________________________________
  164.  
  165. - - - - - - - - - - - - - - - - - Tear Here - - - - - - - - - - - - - - - - - -
  166.  
  167. =============
  168. ABOUT ADDLINE
  169. =============
  170.  
  171.         AddLine adds line numbers to BASIC, or other language(s), source code
  172. files.  When using Microsoft's BASIC, QuickBASIC, or compatible compilers,
  173. added line numbers allow use of the ERL function on programs developed without
  174. line numbers.  The ERL function is an excellent way to pinpoint error
  175. locations, especially when they are generated by users at remote sites.
  176.  
  177. ===============
  178. RUNNING ADDLINE
  179. ===============
  180.  
  181.         AddLine's launch syntax is:
  182.         
  183.                 ADDLINE [d:][path]filename[.ext]
  184.         
  185.         AddLine will read the input file, add line numbers, and create an
  186. output file with an ".ADL" extension.
  187.  
  188.         For example, to add lines to a file named FOO.BAS (stored in the
  189. current directory), the launch syntax would be:
  190.  
  191.                         ADDLINE FOO.BAS
  192.  
  193.         AddLine's output file would be named FOO.ADL, and the original FOO.BAS
  194. file would be unchanged.
  195.  
  196.         AddLine will not add line numbers to lines which contain the
  197. underscore ("_") character.  This allows the use of extended-line DIM, FIELD,
  198. and other statements within BASIC source code.
  199.  
  200.         AddLine will not add a line number to the first CASE statement that
  201. appears after a SELECT statement, or to any line which contains an AS
  202. statement.  This compensates for a bug in Microsoft's QuickBASIC 4.0 and BASIC
  203. 6.0 whereby using line numbers in SELECT CASE or TYPE/END TYPE constructs
  204. causes compile-time errors.
  205.  
  206. ========================================
  207. PROGRAMMING AND COMPILING, ADDLINE-STYLE
  208. ========================================
  209.  
  210.         Develop your unnumbered BASIC programs as you usually do, taking the
  211. following steps into consideration:
  212.  
  213.         1.  Use labels as the targets of all GOTO's, GOSUB's, etc.
  214.  
  215.         2.